home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 2339.ZIP / DRMEN101.DOC < prev    next >
Text File  |  1988-09-06  |  8KB  |  177 lines
  1. DRMENGEN  ver 1.01 CHANGES   SEPT 5, 1988
  2.  
  3. -    'QUICK DOS' now calls COMMAND.COM if it is on the root directory
  4.     of C:
  5.  
  6. -    Fixes generated code bug.  Now when the Esc key is pressed to clear a
  7.     drop menu, the background colors are not changed.
  8.  
  9. -   The *.CFG file have been extended for all color combinations and are
  10.     slightly modified.  Ver 1.00 will not load *.CFG files saved in
  11.     ver 1.01.  Ver 1.01 will load both versions of the *.CFG files.
  12.  
  13. -   Corresctly saves procedure file for DBASE.
  14.  
  15. *******************************************************************
  16.  
  17.                       DRMENGEN   ver 1.0  Sept 1, 1988
  18.                                - SHAREWARE -
  19.  
  20. AUTHOR:               BRIAN H HUNT
  21.  
  22.       ADDRESS TILL: 10 NOV, 1988    2727 DUKE ST, APT 1310
  23.                                     ALEXANDRIA, VA   22314
  24.                                     Phone: (703) 751-6010
  25.  
  26.              AFTER: 10 NOV, 1988    4750 GLENDALE AVE NE
  27.                                     SALEM, OR   97303
  28.                                     Phone: TBD
  29.  
  30.                       GEnie  DILITHIUM
  31.                       CIS    72637,2407
  32.                       Delphi NEOMAN
  33.  
  34.     DRMENGEN is a dropdown menu shell generator for CLIPPER and DBASE III.
  35. It is intuitive and easy to use.  It permits the user to quickly re-edit
  36. menu shells through the use of configuration data file written to disk as
  37. well as the generated menus.  A great deal of work went into this program, so
  38. I ask of you to support the SHAREWARE concept and slip me a donation of
  39. $ 25.00.  With a donation, you will recieve future upgrades and source code.
  40. DRMENGEN was compiled under CLIPPER.  This is the first of several code
  41. generators for the DBASE environment and if the shareware concept is
  42. adequately supported, I will upload them also.
  43.  
  44.  
  45.     Inspiration for DRMENGEN came from Simon Poole's excellent Menu
  46. generator for DBASE menus.  I expanded on it significantly and tried to
  47. make it as useful as I can for developers.  I write a considerable amount
  48. of code for Clipper developed applications at work and saw a need for a
  49. code generator to help standardize program interfaces.
  50.  
  51.  
  52.          ARCHIVE CONTENTS
  53.  
  54.             DRMENGEN.EXE  The code generator - needs no other files to run
  55.  
  56.             DRMENGEN.DOC  This document
  57.  
  58.             EXAMPLE.PRG   A strip downed version of generated code to help
  59.                           show general logic.  Best printed out using
  60.                           condensed mode.
  61.  
  62.             TEST1.CFG     An example MENU configuration file that DRMENGEN
  63.                           saves as well as generated code.  To modify a
  64.                           generated menu, just load the corosponding *.CFG
  65.                           and quickly edit it, re-generate and re-compile
  66.  
  67.             CLDR.BAT      sample batch file for compiling with MSDOS linker
  68.  
  69.             CURSON.OBJ    called modules needed for compiling to turn
  70.             CURSOFF.OBJ   cursor on or off
  71.  
  72.     This program has been thoroughly tested for Clipper.  Since, I use
  73. Clipper entirely at work and do not use DBASE, the generated code has not
  74. been tweeked for DBASE.  However, where there are differences, DRMENGEN
  75. writes the specific code for DBASE.  My guess is that it might be too slow
  76. for interpreter operation. The generated code works well on my Z-248 for
  77. Clipper.  I would appreciate any comments on DRMENGEN and the code it
  78. generates.
  79.  
  80.  
  81.     TO USE DRMENGEN      (Hard drive is best)
  82.  
  83.     1. Load DRMENGEN
  84.  
  85.     2. Either load a previously saved configuration file *.CFG by
  86.        selecting 'LOAD MENU DATA' under the 'FILES' menu or
  87.        select 'PARAMETERS' under the 'DESIGN' menu.
  88.  
  89.        Once this is done, it doesn't matter what order you use to
  90.        create the menu shell.  Your options are under the 'DESIGN' menu.
  91.  
  92.        OPTIONS: 'DESIGN MENU'
  93.  
  94.    PARAMETERS:   'PARAMETERS' Enter the name for the code to be generated -
  95.                  DRMENGEN will add the '.PRG' extension.  The menu data file
  96.                  or configuration file will use the same name with a '.CFG'
  97.                  extension.  Answer 'Y' if for Clipper.  If you type 'N'
  98.                  DRMENGEN will write an additional file called MENUPROC.PRG
  99.                  containing all the procedures called by the menu.  They are
  100.                  all written together when Clipper is enabled.  Default
  101.                  values are shown.  Default name 'TEMPMAIN'.
  102.  
  103.                  The screen coordinates for Clipper and DBASE have 0,0 in the
  104.                  upper left corner and 24,79 in the lower right corner.  If
  105.                  the MENULINE is 1, the menubar will be on the second line or
  106.                  line 1 for Clipper.  MENUWIDTH is the spacing from the first
  107.                  character of one menu to the first character of the next
  108.                  menu.  The maximum number of displayed
  109.                  characters is 80.  MENUWIDTH * NUMBER MENUS must be <= 80.
  110.                  DRMENGEN will make sure it is less than 80 and will reduce
  111.                  MENUWIDTH if necessary.
  112.  
  113.                  Spacing between the MENULINE or MENUBAR and the drop menus
  114.                  can be set.
  115.  
  116.    HEADING:      'HEADING'  Up to 5 lines of heading can be written here
  117.                  depending on the position of the menubar.  The menubar
  118.                  or called menuline is set under 'PARAMETERS'.
  119.  
  120.  
  121.    MENUS:        The selection 'MENUS' under the menu 'DESIGN' is use to fill
  122.                  in the string variables to be displayed and the names of the
  123.                  subroutines to be called, when selected.  After setting
  124.                  the menu parameters, this selection will enable you to give
  125.                  names for each menu heading on the menubar and the number of
  126.                  subroutines or options per heading (max 8 menus with 10
  127.                  options each).  After entering these values, DRMENGEN will
  128.                  bring up each dropmenu, one at a time, so you can enter the
  129.                  string variables for for the selection names and the names of
  130.                  their corosponding subroutines.  Values shown are default.
  131.                  Item 0./Menu 0. is the default exit selection.
  132.  
  133.    COLORS:       This selection brings up a sample menu and allows you to
  134.                  change colors simply by using the cursor keys.  The colors
  135.                  displayed when the Esc key is pressed will be saved to the
  136.                  generated code.  They can be changed.
  137.  
  138.    TEST MENU:    This selection brings up a complete working version of the
  139.                  generated code before saving it.  It allows you to view its
  140.                  appearance as you make changes in any of the 'DESIGN'
  141.                  selections.  This displayed version is slower than what the
  142.                  generated code will be.
  143.  
  144.                  Once a menu is initializing by first selecting 'PARAMETERS'
  145.                  or loading a previously saved *.CFG file, you can change ALL
  146.                  'DESIGN' items to include all PARAMETERS.  Once you have what
  147.                  you want, either save just the MENU DATA FILE (*.CFG) or
  148.                  generate the menu.  If you forget to save your menu, DRMENGEN
  149.                  will save a configuration or menu data file called:
  150.  
  151.                                  LASTXXXX.CFG
  152. RESERVED VARIABLE NAMES:
  153.     DRMENGEN uses the following variable names and procedure names.  Avoid
  154. using these any where in your application:
  155.  
  156.    SNUMMENUS       SLINE          MENUSET
  157.    SMENULINE       SOFFSET        MENUHEAD
  158.    SMENUWIDTH      SNUM           SDROP*
  159.    SNUMOPT         SCNTR          SSTART
  160.    SNUMOPT*        SCHOICE        SFINISH1
  161.    SSOPT           SMCHOICE       SFINISH2
  162.    SSSOPT**        SKEYPRESS      MESSOUT
  163.    SMOPT*          SMENUMODE      MESSOUT1
  164.    SCHCOL          SDONE          MESSOUT3
  165.    SSELOLD         SY_END
  166.    SMENUITEM       SSELOPTOLD
  167.  
  168.     I hope you find this useful.  Again, I would gladly entertain any
  169. questions or comments you may have.
  170.  
  171.                                      Brian H. Hunt
  172.  
  173.      DBASE, DBASE III and DBASE III+ are registered trademarks of
  174.             Ashton-Tate, Inc.
  175.      CLIPPER is a registered trademark of  Nantucket, Inc.
  176.  
  177. ****************************************************************************